SDK错误码解析及问题排查流程
SDK错误码问题定位总体思路
在接入过程中或者线上用户最常反馈的就是广告无填充问题，当遇到这类问题时，建议：
①及时查看相关错误码埋点情况
②当通过诊断分析无法定位问题时，可通过抓包或日志明确ADN具体错误码。
③支持通过- (NSArray<CloooudMAdLoadInfo > )getAdLoadInfoList;获取加载失败的ADN错误信息，根据LoadInfoList详情发现并定位问题。
聚合维度高频错误码解析
| 错误码 | 说明 | 排查建议 |
|---|---|---|
| 10086 | 所有层所有ADN次无广告返回 | 建议增加兜底代码位，如果已配置兜底代码位，建议通过查看穿山甲媒体平台诊断分析模块进行定位或通过穿山甲抓包来明确广告无填充原因 |
| 10010 | 所有代码位还未请求完成就触发了总超时时间 | 建议延长瀑布流总超时时长或者缩短层超时并添加兜底代码位 |
| 40006 | 广告位ID不合法,请检查广告聚合平台的相关配置 | 建议检查是否是新建广告位ID，是否在请求赋值时多空格等操作 |
| 10040 | 因暂无广告聚合平台的相关配置无法加载Ad，配置丢失相关可能原因：请求中、配置请求必要参数设定错误、网络链接失败!如果Ad类型非开屏广告，请尽量在各ad的setConfigSuccessCallback中loadAd | 除开屏广告外，建议在config回调成功后再发起广告请求 |
| 40040 | 暂无配置信息 | 当发生此场景时，建议优先检查应用ID是否赋值正确，是否有多余空格等，当无法定位到相关问题时，建议通过抓包查看config文件夹下的请求信息反馈给对应的技术支持同学 |
| 40044 | 命中ADN错误码，进入冷冻期，实际未发起请求 | 建议延长请求频次间隔或者通过穿山甲媒体平台，设置该广告位ID下的瀑布流属性设置内的展示控制 |
| 40045 | 因广告配置数据出错，导致实际广告请求未发起 | 建议检查瀑布流相关配置，如检查是否存在广告类型配置错误等场景 |
| 40047 | 同一广告对象不能多次加载(广告还未展示)，请使用新的广告对象 | 需注意每次加载广告时需重新创建新的广告对象，不能使用同一个广告对象多次请求 |
| 40048 | 同一广告对象不能多次加载(广告已经展示)，请使用新的广告对象 | 需注意已经展示过的广告对象不能重复使用，需要使用新的广告对象 |
| 40050 | ADN填充失败，但无具体错误信息 | 建议通过查看穿山甲媒体平台诊断分析模块进行定位或通过穿山甲抓包来明确广告无填充原因 |
| 40051 | ADN版本错误引起的加载失败 | 请参照对接文档SDK接入模块，对照接入的ADN版本 |
| 40052 | 无可用广告引起的展示失败 | 开发者可在展示失败回调确认该错误码情况，如果是穿山甲广告可优先检查是否是调整了系统时间导致的 |
| 40200 | 广告类型不匹配 | 建议通过各ADN对应Cloooud广告样式明确接入的广告类型情况，参照对接文档各广告类型模块说明明确对应广告请求方法，以确保正确完成广告接入，避免由于广告类型不匹配导致的无广告填充 |
| 44406 | 广告位ID不合法 | 当发生此场景时建议优先检查广告位ID的状态是否正常 |
当开启融合SDK功能时，如果发现以下错误码可按照处理建议进行排查。
| 错误码 | 说明 | 排查建议 |
|---|---|---|
| 840027 | 开屏广告自定义兜底参数不正确 | 建议检查设置的自定义兜底参数是否准确 |
| 840028 | 开屏广告开发者自定义兜底中应用ID与SDK初始化的应用ID不一致 | 如若设置开屏广告的自定义兜底代码位是CSJ，请确保设置的应用ID与SDK初始化保持一致 由于自定义兜底代码位建议创建非聚合属性代码位 |
| 840031 | 聚合代码位对应的广告类型和当前广告类型不一致 | 建议在ADN后台明确创建的广告类型，需确保在穿山甲媒体平台匹配设置 |
| 840040 | 暂无配置信息 | 当发生此场景时，建议优先检查应用ID是否赋值正确，是否有多余空格等，当无法定位到相关问题时，建议通过抓包查看config文件夹下的请求信息反馈给对应的技术支持同学 |
| 840041 | waterfall层级展示次数达到上限，本次广告加载被阻止 | 建议通过穿山甲媒体平台，查询该广告位ID下的瀑布流属性设置内的展示控制设置天级别频控是否达到上限导致的 |
| 840042 | waterfall层级展示间隔未超过规定的最短时长，本次广告加载被阻止 | 建议通过穿山甲媒体平台，查询该广告位ID下的瀑布流属性设置内的展示控制设置用户小时级别频控是否达到上限导致的 |
| 840043 | 命中聚合维度的频繁请求熔断机制，实际未发起请求 | 建议延长请求频次间隔或者通过穿山甲媒体平台，设置该广告位ID下的瀑布流属性设置内的展示频控限制 |
广告网络常见错误码
GDT
| 错误码 | 说明 | 排查建议 |
|---|---|---|
| 4001 | 初始化错误, 包括广告位为空、App ID为空、Context/Activity为空 | 在广告位ID和应用ID无误的前提下，请检查展示广告的Context/Activity是否为空 |
| 4007 | 当前设备或版本不支持 | 请参照本文档中相应广告类型对设备或版本的限制 |
| 5002 | 视频素材下载错误 | 建议稍后重试，如果重试仍然有错误，请反馈给优量汇运营 |
| 5004 | 未匹配到合适的广告 | 此情况下禁止多次重试请求广告，否则可能影响系统对您流量的评价从而影响变现效果 |
| 5006 | 包名校验错误，当前 App 的包名和优量汇官网注册媒体时填写的包名不一致，因此无广告返回 | 请检查接入优量汇 SDK 的 App 包名是否和注册时填写的一致，否则将影响您的收益 |
| 5010 | 广告样式校验失败，请检查广告位与接口使用是否一致 | 目前后台开放权限的是平台模板广告，请根据平台模板广告的接入文档进行接入，如果是按照自渲染广告接入文档进行接入的话，也会报错107034 |
| 2001 | 初始化错误 | 开发者自查参数问题 |
| 2003 | SDK未初始化 | 根据 Logcat 中的错误信息提示修改嵌入代码 |
| 3003 | 网络不可用 | 网络不可用，无法连接到服务器 |
| 5013 | 广告请求过于频繁 | 请求过于频繁，服务器繁忙时会返回该错误码，请检测与控制请求频率 |
| 4011 | 开屏广告拉取超时，请自查开屏广告的拉取超时时间设置是否过短 | 根据 Logcat 中的错误信息提示修改嵌入代码 |
| 5010 | 广告样式校验失败，请检查广告位与接口使用是否一致 | 目前后台开放权限的是平台模板广告，请根据平台模板广告的接入文档进行接入，如果是按照自渲染广告接入文档进行接入的话，也会报错107034 |
| 2001 | 初始化错误 | 开发者自查参数问题 |
| 5022 | 模板激励视频渲染失败 | 建议稍后重试，如果重试仍然有错误，请反馈给优量汇运营 |
| 4002 | 请检查 Manifest 文件中的 Activity/Service/Permission 的声明是否正确以及声明的权限是否都已授予 | 请检查 Manifest 文件中的 Activity/Service/Permission 的声明是否正确以及声明的权限是否都已授予 |
| 5012 | 广告数据过期 | 部分广告（如激励视频）可以预拉取，拉取广告后广告数据会有存在一个过期时间，当开发者调用展示广告的接口但此时当前时间已经超过过期时间时会返回此错误码 |
| 102006 | 没有匹配到合适的广告。 | 禁止重试，否则可能触发系统策略导致流量收益下降。 |
| 100133 | 广告位填写错误，或广告位状态处于关闭状态；如是新建广告位并立刻请求了广告，则会由于系统索引不到而导致请求失败 | 请求中包含无效的广告位，请确认对应的广告位ID的状态；新建广告位，请在新建30分钟后请求广告 |
| 100135 | 广告位状态冻结 | 请检查广告位状态。 |
| 109502 | 请求过于频繁或返回未曝光，且产生的收入低，触发平台出于成本考虑的填充限制 | 无法识别当前的网络环境，视频广告需要在WIFI和4G网络环境下请求，其他环境会返回这个报错，建议切换当前网络到WIFI或者4G再次尝试一下 无合适广告资源返回，请控制广告请求频次 |
更多相关错误信息请查看：GDT SDK错误码
百度
| 常见错误信息 | 处理建议 |
|---|
|获取不到广告|如为激励视频，需咨询百度相关人员申请白名单 | |加载Banner广告时一直没有回调|ATBannerView需要先add到window上再发起加载请求| 更多的百度错误码信息请查看（需登录）：百度SDK错误码
KS
| 常见错误信息 | 说明 |
|---|---|
| 40001 | 没有网络 |
| 40002 | 数据解析失败 |
| 40003 | 广告数据为空 |
| 100001 | 参数有误 |
| 310001 | appId未注册 |
| 310002 | appId无效 |
| 310003 | appId已封禁 |
| 310004 | packageName与注册的packageName不一致 |
| 310005 | 操作系统与注册的不一致 |
| 320002 | appId对应账号无效 |
| 320003 | appId对应账号已封禁 |
| 330001 | posId未注册 |
| 330002 | posId无效 |
| 330003 | posId已封禁 |
| 330004 | posid与注册的appId信息不一致 |
更多的KS错误信息请查看：KS错误码
问题反馈模版 为了确保定位问题更高效，较少双方沟通成本，建议反馈问题时按照如下模版提供对应信息
①SDK版本（必要）
②ADN版本（必要）
③手机机型及系统版本（可选）
④详细的问题描述（必要）
⑤广告类型（模版/自渲染）（可选）
⑥应用ID/广告位ID/代码位ID（必要）
⑦是否必现（可选）
⑧操作录屏或截图（最好是录屏）（可选，展示异常时必要）
⑨素材抓包（展示异常场景，可选）
⑩堆栈信息（最好提供文本信息；截图不建议，崩溃场景必要）
⑪debug包（可选，方便问题排查及场景复现）